home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / batch / inputenv.lha / InputEnv / InputEnv.readme < prev    next >
Encoding:
Text File  |  1994-05-15  |  5.7 KB  |  137 lines
  1. OBJECT NAME: InputEnv (v2.0)
  2. AUTHOR: John E> Perry, ///
  3. REQUIREMENTS: AmigaDOS 2.0+
  4.  
  5. Copyright © 1994
  6.  
  7. LEGAL STUFF
  8. This program is freely distributable under the following conditions:
  9.      1> By using this program, user implicitly agrees to accept full
  10.     responisibility for any damage ensuing to her/his computer
  11.     system, whether by misuse of this program or otherwise.
  12.      2> If the user chooses to modify the contents of the program,
  13.     s/he agrees NOT to do so for malicious purposes of ANY sort,
  14.     and to notify author of program upon any release of said
  15.     modification.
  16.      3> If you can't follow these simple rules, you're too STUPID to
  17.     prosecute.  And you're also part of the reason the Amiga is
  18.     in danger, and only big companies can afford to mass-produce
  19.     software for profit.
  20.  
  21. INTRODUCTION
  22. This can be done with AREXX, which may or may not be a more elegant
  23. solution.  (Obviously, *I* don't think so.)  At any rate, InputEnv
  24. is designed to prompt the user for some reponse, which then becomes
  25. either a global or a local environment variable.
  26.     For example, I use it in my S:Shell-Startup script like so:
  27.     InputEnv SUPPRESS SHELL UserName Please input your name:
  28. and upon the user's response, the shell variable UserName is created.
  29.  
  30. DIRECTIONS
  31. This program is ONLY meant to run from the CLI.  (Besides, it crashes
  32. the Workbench.)  You call the program as follows:
  33.     InputEnv [SUPPRESS] [SHELL] <env-name> <prompt>
  34. The command-line arguments are:
  35.     SUPPRESS    Automatically overwrite any existing
  36.             environment variable with this name.
  37.             This flag is optional, and if omitted,
  38.             will ask the user, "Variable already
  39.             exists! overwrite? (Y/N) "
  40.     SHELL        Create a local (this shell only)
  41.             variable.  If omitted, the variable
  42.             will be a system-wide variable.
  43.     <env-name>    REQUIRED ARGUMENT!  This is one word,
  44.             a valid AmigaDOS filename (see the
  45.             AmigaDOS User's Guide), which is the
  46.             name of the environment variable you
  47.             wish to create.
  48.     <prompt>    REQUIRED ARGUMENT!  This is up to
  49.             127 charcaters, as many words as you
  50.             like, of a prompt for the user.  A
  51.             space is automatically appended.
  52.  
  53. In the example above, the user sees:
  54.  
  55.         Please input your name: _
  56.  
  57. and upon doing so, the shell variable UserName is created.  If the shell
  58. variable already exists, it is overwritten.
  59.  
  60. FOR REFERENCE
  61. The AmigaDOS User's Guide (a manual that comes with every Amiga) has an
  62. explanation of environment variables and some of their uses.  In my
  63. version (AmigaDOS 2.1), this is on pages 4-4 to 4-6.
  64.     The author is always a wonderful reference.  You can reach me at:
  65.     jep@nauvax.ucc.nau.edu            (Internet)
  66.     700 S. Blackbird Roost Apt. # 217    (Temporarily Permanent)
  67.     Flagstaff, AZ
  68.     86001
  69.     124 Archer Rd.                (Permanently Permanent)
  70.     Newport News, VA
  71.     23606-1102
  72.  
  73. It is a GOOD idea to send me some mail on this program, no matter WHAT you
  74. think of it.  I have posted several programs on the Internet and received
  75. NO correspondence whatsoever about them, which is, of course, depressing.
  76. Even if they ARE all terribly, I wish someone would TELL me.  These
  77. programs are:
  78.     GraphDQ        Graphs differential equations; complete GUI
  79.     m2format    Prettifies Modula-2 program listing.  Rather
  80.             neat.  It was used to generate the included
  81.             file InputEnv.mod.fmt, which, when printed
  82.             or More'd (NOT MuchMore'd, which doesn't work
  83.             right) has a nice effect.
  84.     BigCalc        Pseudo-arbitrary integer calculator.
  85.     InputEnv    An earlier version of this program, written
  86.             in C- i.e., before I saw the light.
  87.     CatsEyes    All around the WB screen, the Cat's Eyes
  88.             followed the mouse...
  89.     MineRunner    A rather odd version of the Mine Mania
  90.             sweeping programmers for a while.
  91.  
  92. ACKNOWLEDGEMENTS
  93.     1> My Lord and Saviour Jesus Christ, without whom all this would
  94. be impossible.
  95.     2> Armadillo Software, for the Benchmark Modula-2 compiler and
  96. Workbench 2.0 modules.
  97.     3> Niklaus Wirth, for creating Modula-2, an elegantly simple yet
  98. powerful programming language.
  99.     4> My parents for starting it all so long ago with a TRS-80
  100. Color Computer, back when 16K and 8 colors was HOT...
  101.     5> All the professors and teachers I've had who've influenced
  102. me for the better, including, but not limited to, Dr. Vanessa Job,
  103. Clare Booth Luce Professor of Mathematics and Computer Science at
  104. Marymount University in Arlington, VA.
  105.  
  106. PREVIEWS OF COMING ATTRACTIONS
  107.     EZView        An Intuition-based text viewer, like More,
  108.             MuchMore, Most, etc., only with scroller
  109.             gadgets and menus instead of cryptic keys
  110.             to remember and DMA-choking screen scrolls.
  111.     EZWrite        An Intuition-based text editor.  Basically
  112.             this will be a software extension of EZView
  113.             which will allow one to edit a file, too.
  114.     EZInterface    An interface builder for Intuition,
  115.             GadTools, and perhaps even BOOPSI objects.
  116.             Minimize coding; maximize happiness.
  117.     EZMem        Application-based garbage collection.  NOT
  118.             system-wide.
  119. The development of all these, as well as their order, will depend
  120. on the response of users.  However, EZView is almost done.
  121.  
  122. FINAL NOTE
  123.     It is next to impossible to pirate one of my programs, but
  124. with the demise of Commodore, a few things should be said.  Unlike
  125. the Mac and PC camps, the Amiga community CANNOT afford piracy.  I
  126. remember taking the NTE last year and actually witnessing a high-
  127. school teacher BRAG to someone about how he'd obtained Quattro,
  128. Excel, WordPerfect, and other Windows programs for free.
  129.     Unlike other computers, the Amiga isn't generally a
  130. billion-dollar industry for anyone, except perhaps billion-dollar
  131. debts.  We don't have companies like Microsoft and WordPerfect that
  132. can charge $400+ for programs that do little, and ignore rampant
  133. piracy.  Most Amiga companies don't charge ridiculous costs for
  134. their programs.  Please respect that.
  135.  
  136. IF YOU PIRATE AN AMIGA PROGRAM, YOU ARE HELPING TO KILL THE AMIGA.  
  137.